Notification > KakaoTalk Bizmessage > 오류 코드

API 응답 코드

service isSuccess resultCode resultMessage
공통 true 0 성공
공통 false 4 파라미터 유효성 검증 실패(resultMessage 참고)
공통 false -1000 유효하지 않은 앱키
공통 false -1001 유효하지 않은 비밀 키(secretKey)
공통 false -1002 유효하지 않은 SMS 앱키
공통 false -1003 유효하지 않은 SMS 발신 번호
공통 false -1004 이미 등록된 발신프로필
공통 false -1005 10분간 동일한 X-NC-API-IDEMPOTENCY-KEY 값으로 메시지 발송을 요청한 경우
공통 false -1008 발신프로필 토큰 등록 실패
공통 false -1010 발신프로필 그룹이 존재하지 않을 경우
공통 false -1013 이미 존재하는 발신프로필 그룹일 경우
공통 false -1014 활성화 되지 않은 발신프로필일 경우
공통 false -1016 메시지를 찾을 수 없을 경우
공통 false -1017 일별 발송량을 초과한 발송 실패
공통 false -1018 이미 발신프로필 그룹에 등록된 경우
공통 false -1019 유효하지 않은 대체 발송 080수신거부 번호
공통 false -1022 발신프로필이 그룹에 등록되지 않은 발신프로필일 경우
공통 false -1023 발신프로필이 그룹이 최대 10개가 초과한 경우
공통 false -1024 발신프로필이 그룹으로 메시지를 발송할 경우
공통 false -1025 발신프로필 삭제 API로 발신프로필 그룹 삭제 시도한 경우
공통 false -1026 발신프로필 그룹의 멤버가 5000개가 초과한 경우
공통 false -1027 발신프로필이 차단 상태일 경우
공통 false -1028 템플릿 변수가 치환될 때 그 차이가 14개 글자를 초과하는 부분이 있는 경우(최초 사용자 제한)
공통 false -1029 그룹 프로필에 멤버로 추가할 수 없는 경우(최초 사용자 제한)
공통 false -1030 본인인증을 받지 않은 경우
공통 false -2000 특정 필드값이 최대 길이 초과할 경우
공통 false -2001 특정 필드값이 필수 값이 공백인 경우
공통 false -2002 특정 필드값이 NULL일 경우
공통 false -2003 특정 필드값이 최소 길이보다 작을 경우
공통 false -2017 존재하지 않는 발신프로필
공통 false -2018 유효하지 않은 버튼 파라미터
공통 false -2019 템플릿 본문 1,000글자 초과로 실패
공통 false -2022 이미지를 첨부하였는데 이미지링크(imageLink)를 입력하지 않은 경우
공통 false -2023 친구톡 메시지 본문이 400글자 초과할 경우(이미지 첨부)
공통 false -2024 친구톡 메시지 본문이 1,000글자 초과할 경우
공통 false -2025 예약 일시가 과거의 일시일 경우
공통 false -2026 예약 일시가 90일 이후의 일시일 경우(최대 90일까지 가능)
공통 false -2027 날짜 포맷이 달라 파싱 오류 발생
공통 false -2028 유효하지 않은 요청 ID
공통 false -2029 요청한 메시지가 없거나, 취소할 수 있는 메시지가 없는 경우
공통 false -2030 와이드 이미지 발송 시, 최대 본문 길이 76자 초과한 경우
공통 false -2031 와이드 이미지 발송 시, 최대 버튼 개수 2개 초과한 경우
공통 false -2032 템플릿 제목이 50자를 초과한 경우
공통 false -2033 템플릿 아이템 파라미터가 유효하지 않은 경우
공통 false -2034 템플릿 아이템 하이라이트 파라미터가 유효하지 않은 경우
공통 false -2035 템플릿 헤더가 16자를 초과한 경우
공통 false -2036 TemplateRepresentLink 파라미터가 유효하지 않은 경우
공통 false -2037 아이템 리스트 포함 템플릿 등록 시 메시지 본문 글자 수가 700자를 초과한 경우
공통 false -2500 대량 발송 요청을 찾을 수 없는 경우
공통 false -2501 요청한 메시지가 없거나, 취소할 수 있는 메시지가 없는 경우
공통 false -2502 발송 실패 설정이 되어 있지 않고, 대체 발송을 요청했을 경우
공통 false -2504 유효하지 않은 바로연결
공통 false -2505 바로연결 포함 발송 시, 최대 버튼 개수 2개를 초과한 경우
공통 false -2999 발송 요청한 모든 수신자 요청 실패
공통 false -3000 웹 링크(WL) 버튼 타입의 템플릿일 경우, linkMo 필수 필드
공통 false -3001 이미 존재하는 템플릿 코드 또는 템플릿명
공통 false -3002 필요한 요청 본문(request body) 내용을 읽을 수 없을 경우
공통 false -3003 존재하는 않는 템플릿
공통 false -3004 발송할 템플릿 파라미터 오류
공통 false -3005 템플릿 상태 오류(승인 전 발송 요청 시)
공통 false -3006 버튼 URL은 반드시 http:// 또는 https://를 포함해야 합니다.
공통 false -3007 자유 버튼 타입의 템플릿만 버튼명과 버튼 URL 입력 가능합니다.
공통 false -3008 배송 조회 버튼 타입은 버튼 URL을 입력할 수 없습니다.
공통 false -3009 버튼명이 존재하지 않습니다.
공통 false -3010 등록한 템플릿 본문과 일치하지 않는 경우
공통 false -3011 등록한 템플릿 버튼과 일치하지 않는 경우
공통 false -3012 수정할 수 없는 템플릿 상태(승인/반려 상태만 가능)
공통 false -3013 이미 수정 중인 템플릿이 존재
공통 false -3014 버튼 타입이 올바르지 않은 경우
공통 false -3015 CBT 기능이 비활성화된 플러스친구일 경우
공통 false -3016 강조 표기형 템플릿은 templateTitle, templateSubtitle 필수 필드
공통 false -3017 templateSubtitle 은 치환 변수를 사용 불가
공통 false -3018 부가 정보형 템플릿은 templateExtra 필수 필드
공통 false -3020 복합형 템플릿은 templateExtra, templateAd 필수 필드
공통 false -3021 templateExtra은 치환 변수를 사용 불가
공통 false -3024 AC 타입 버튼은 채널 추가형 복합형 템플릿만 등록 가능
공통 false -3025 AC 타입 버튼은 단독으로 사용하거나, 가장 위에 위치해야하는 제약에 어긋난 경우
공통 false -3026 AC 타입 버튼의 이름은 "채널 추가" 만 등록 가능
공통 false -3027 템플릿 강조 표시 타입 기본(NONE)로 등록 시, templateTitle, templateSubtitle 필드를 등록할 수 없음
공통 false -3028 템플릿 메시지 유형 기본형(BA)일 경우, templateExtra 필드를 등록할 수 없음
공통 false -3030 템플릿 메시지 유형 채널 추가형(AD)일 경우, templateExtra 필드를 등록할 수 없음
공통 false -3031 그룹 템플릿은 템플릿 메시지 유형 채널추가형(AD), 복합형(MI)를 사용할 수 없음
공통 false -3032 템플릿 강조 표시 타입 이미지형(IMAGE)일 경우, templateImageName, templateImageUrl 필드 필수값
공통 false -3033 버튼 또는 바로연결이 템플릿에 등록되지 않았을 경우
공통 false -3034 삭제할 템플릿이 3일이내 발송 이력이 있을 경우
공통 false -3035 템플릿 강조 표시 타입 아이템리스트형(ITEM_LIST)로 등록 시, templateHeader, templateImageName, templateImageUrl, templateItem, templateItemHighlight 필드 중 1개 이상 필수로 포함
공통 false -3036 템플릿 강조 표시 타입 아이템리스트형(ITEM_LIST)로 등록 시, 보안 템플릿으로 등록할 수 없음
공통 false -3037 templateItem list의 title은 치환 변수를 가질 수 없음
공통 false -3038 templateItem summary의 title은 치환 변수를 가질 수 없음
공통 false -3039 templateItem summary은 templateItem list없이 존재할 수 없음
공통 false -3040 아이템하이라이트의 title은 최대 21글자, description은 최대 13글자
공통 false -3041 imageUrl은 http:// https:// 프로토콜을 반드시 포함해야 함
공통 false -3042 templateHeader이 템플릿과 일치하지 않는 경우
공통 false -3043 templateItem 또는 templateItemHighlight이 템플릿과 일치하지 않는 경우
공통 false -3044 비지니스폼(BF) 타입 버튼은 단독으로 사용하거나, 가장 위에 위치해야하는 제약에 어긋난 경우
공통 false -3045 비지니스폼(BF) 타입의 name이 "톡에서 예약하기", "톡에서 설문하기", "톡에서 응모하기" 이 아닐 경우, 또는 등록되지 않은 bizFormKey일 경우
공통 false -3046 templateRepresentLink이 템플릿과 일치하지 않는 경우
공통 false -3100 템플릿 요청/승인 상태의 경우 comment를 추가할 수 없음
공통 false -3101 바로 연결 이름이 존재하지 않는 경우
공통 false -3102 바로 연결은 치환자를 포함할 수 없음
공통 false -3103 버튼 혹은 바로 연결의 형식이 올바르지 않은 경우 (json 형식이 아니거나, escape 되지 않은 문자가 섞여있음)
공통 false -3200 와이드 아이템리스트에 name이 누락된 경우
공통 false -3201 와이드 아이템리스트에 image가 누락된 경우
공통 false -3202 와이드 아이템리스트에 linkMo가 누락된 경우
공통 false -3203 와이드 아이템리스트는 3~4개의 크기의 list와 header가 필수적
공통 false -3204 캐러셀에 header가 누락된 경우
공통 false -3205 캐러셀에 message가 누락된 경우
공통 false -3206 캐러셀에 attachment가 누락된 경우
공통 false -3207 캐러셀에 image가 누락된 경우
공통 false -3208 캐러셀에 2~6개의 크기의 list와 tail이 필수적
공통 false -3209 캐러셀의 tail에 linkMo가 누락된 경우
공통 false -3210 쿠폰은 title과 description이 필수적
공통 false -3211 FI/FT 타입 친구톡 메시지의 경우 쿠폰의 description은 12자를 초과할 수 없고, FW/FL 타입의 경우 18자를 초과할 수 없음
공통 false -3212 쿠폰의 title 내용이 유효하지 않은 경우
공통 false -3213 쿠폰은 모바일 링크 혹은 채널형 ios/android 링크가 필수적
공통 false -3214 FC 타입 친구톡 메시지의 경우 쿠폰을 사용할 수 없음
공통 false -3215 와이드 아이템리스트와 캐러셀은 광고 타입일 경우에만 사용 가능
공통 false -4003 조회 범위는 한 달 초과
공통 false -4004 존재하지 않는 앱키
공통 false -4005 사용 종료 상태의 앱키
공통 false -4007 파일 사이즈 초과 초과
공통 false -4009 유효하지 않은 파일 확장자
공통 false -4015 유효하지 않은 요청 ID(requestId)
공통 false -4025 템플릿 업로드 시, 최대 20개를 초과한 경우
공통 false -4026 템플릿 업로드 파일의 헤더가 유효하지 않은 경우
공통 false -4027 버튼 길이가 최대치인 상태로 채널 추가형 전환을 하려고 하는 경우
공통 false -4028 승인되지 않은 템플릿으로 채널 추가형 전환을 하려고 하는 경우
공통 false -4101 유효하지 않은 통계 조회 파라미터
공통 false -4103 조회 시, 발송 요청 시작 시간/발송 요청 끝 시간값이 없을 경우
공통 false -4200 유효하지 않은 대체 발송 메시지
공통 false -5000 유효하지 않은 수신 번호
공통 false -6000 고정형(F) 내용 유형은 변수를 포함할 수 없음
공통 false -6001 변수형(V) 내용 유형은 반드시 변수를 포함해야 함
공통 false -6002 변수는 총 20개 이상 포함할 수 없음
공통 false -6003 변수는 영문/숫자/특수문자('-', '')만 사용할 수 있으며 20자 이내로만 가능
공통 false -6004 와이드형(W) 메시지 타입은 본문 76자 이내, 버튼 2개까지 가능
공통 false -6005 채널 추가(AC) 타입 버튼은 이미지형(I) 메시지 타입일 경우, 첫 번째 순서에 위치해야 합니다.
와이드형(W) 메시지 타입일 경우, 마지막에 위치해야 합니다.
공통 false -6006 비지니스폼(BF) 타입 버튼은 bizFormId 값이 반드시 존재해야 합니다.
이미지형(I) 메시지 타입일 경우, 첫 번째 순서에 위치해야 합니다.
와이드형(W) 메시지 타입일 경우, 마지막에 위치해야 합니다.
이미지형(I) 메시지 타입이면서 채널 추가(AC) 타입 버튼과 같이 사용할 경우, 두 번째에 위치해야 합니다.
와이드형(W) 메시지 타입이면서 채널 추가(AC) 타입 버튼과 같이 사용할 경우, 첫 번째에 위치해야 합니다.
공통 false -6007 080 수신거부 번호 유효성 검사 실패
공통 false -7000 벤더 요청 API 실패
공통 false -8000 이미지 시퀀스(imageSeq)가 없는 경우
공통 false -8001 이미지 파일이 정상적이지 않은 경우
공통 false -8002 이미지 시퀀스(imageSeq)에 대응하는 이미지가 없는 경우
공통 false -8003 이미지 삭제에 실패하는 경우
공통 false -8004 createUser 필드 최대 100자를 초과한 경우
공통 false -8005 이미지 업로드 시 프로젝트에 등록된 플러스친구가 없는 경우
공통 false -8006 인증 메시지 발송 시, 템플릿 내용에 인증 문구가 없는 경우
공통 false -8008 메시지 내용에 금칙어가 포함된 경우
공통 false -8010 네트워크 등의 문제로 이미지 파일 업로드 실패
공통 false -9995 fade-out된 버전의 API를 호출했을 경우
공통 false -9996 Content-type이 application/json가 아닐 경우
공통 false -9997 적절하지 않은 요청으로 인한 실패
공통 false -9998 존재하지 않는 API
공통 false -9999 시스템 오류

알림톡/친구톡 발송 결과 코드

코드값 의미
1000 성공
1001 Request Body가 Json형식이 아님
1002 허브 파트너 키가 유효하지 않음
1003 발신 프로필 키가 유효하지 않음
1004 Request Body(JSON)에서 name을 찾을 수 없음
1006 삭제된 발신 프로필(고객센터에게 문의)
1007 차단 상태의 발신 프로필(고객센터에게 문의)
1011 계약 정보를 찾을 수 없음(고객센터에게 문의)
1012 잘못된 형식의 사용자키 요청
1013 유효하지 않은 앱 연결
1014 유효하지 않은 사업자번호
1015 유효하지 않은 app user id 요청
1016 사업자등록번호 불일치
1021 차단 상태의 카카오톡 채널
1022 닫힘 상태의 카카오톡 채널
1023 삭제된 카카오톡 채널
1024 삭제 대기 상태의 카카오톡 채널
1025 채널 제재 상태로 인한 메시지 전송 실패
1027 채널 메시지 제재 상태로 인한 메시지 전송 실패
1030 잘못된 파라미터 요청
2000 전송 시간 초과
2001 메시지 전송 불가(예기치 않은 오류 발생)
2003 메시지 전송 실패(테스트 서버에서 카카오톡 채널을 추가하지 않은 경우)
3000 예기치 않은 오류 발생
3005 메시지를 발송했으나 수신 확인이 안 됨(성공 불확실, 서버에는 암호화되어 보관되며 3일 이내 수신 가능)
3006 내부 시스템 오류로 메시지 전송 실패
3008 전화번호 오류
3009 메시지 형식 오류
3010 예기치 않은 오류 발생
3011 메시지가 존재하지 않음
3012 카카오 통신 실패
3013 메시지가 비어 있음
3014 메시지 길이 제한 오류
3015 템플릿을 찾을 수 없음
3016 메시지 내용이 템플릿과 일치하지 않음
3018 메시지를 전송할 수 없음
1. 카카오톡 사용했었다가 탈퇴한사람
2. 카카오톡 가입한적이 한번도 없는 사람
3. 알림톡 수신차단
4. 안드로이드 사용자의경우, "핸드폰 유심과 카카오톡 사용번호"가 다른 사람
5. 활성 사용자가 아닌 경우
활성 사용자란?
* 서버와 연결되어 있는 카카오톡 사용자
* 발송 당일 가입한 사용자를 제외한 최근 7일(168시간) 내에 카카오톡을 사용한 사용자
6. 카카오톡 최소 사용버전 및 카톡 미지원, 제재 사용자 등
3022 발송 가능한 시간이 아님(친구톡 메시지는 08시부터 20시 50분까지 발송 가능)
3023 메시지 문법 오류(JSON 형식 오류)
3024 메시지에 포함된 이미지를 전송할 수 없음(이미지주소 또는 링크가 올바르지 않거나 이미지가 규격에 맞지 않음)
3025 변수 글자 수 제한 초과
3026 상담/봇 전환 버튼 extra, event 글자수 제한 초과
3027 메시지 버튼/바로연결이 템플릿과 일치하지 않음
3028 메시지 강조 표기 타이틀이 템플릿과 일치하지 않음
3029 메시지 강조 표기 타이틀 길이 제한 초과(50자)
3030 메시지 타입과 템플릿 강조유형이 일치하지 않음
3031 헤더가 템플릿과 일치하지 않음
3032 헤더 길이 제한 초과(16자)
3033 아이템 하이라이트가 템플릿과 일치하지 않음
3034 아이템 하이라이트 타이틀 길이 제한 초과(이미지 없는 경우 30자, 이미지 있는 경우 21자)
3035 아이템 하이라이트 디스크립션 길이 제한 초과(이미지 없는 경우 19자, 이미지 있는 경우 13자)
3036 아이템 리스트가 템플릿과 일치하지 않음
3037 아이템 리스트의 아이템의 디스크립션 길이 제한 초과(23자)
3038 아이템 요약정보가 템플릿과 일치하지 않음
3039 아이템 요약정보의 디스크립션 길이 제한 초과(14자)
3040 아이템 요약정보의 디스크립션에 허용되지 않은 문자 포함(통화기호/코드, 숫자, 콤마, 소수점, 공백을 제외한 문자 포함)
3042 대표링크가 템플릿과 일치하지 않음
3051 케러셀 아이템 리스트 갯수 최소, 최대 갯수 불일치
3052 케러셀 아이템 메시지 길이 초과
4000 메시지 전송 결과를 찾을 수 없음
4001 알 수 없는 메시지 상태
9998 시스템에 문제가 발생하여 담당자가 확인 중(현재 서비스 제공 중이 아님)
9999 시스템에 문제가 발생하여 담당자가 확인 중(시스템에 알 수 없는 오류 발생)

브랜드톡 발송 결과 코드

코드값 의미
A0000 성공
A1001 Request Body가 JSON형식이 아님
A1003 발신 프로필 키가 유효하지 않음
A1004 Request Body(JSON)에서 name을 찾을 수 없음
A1006 삭제된 발신프로필
A1007 차단 상태의 발신프로필
A1021 차단 상태의 카카오톡 채널
A1022 닫힘 상태의 카카오톡 채널
A1023 삭제된 카카오톡 채널
A1024 삭제대기 상태의 카카오톡 채널
A1025 메시지차단 상태의 카카오톡 채널
A1030 잘못된 파라메터 요청
A1033 템플릿 타입과 메시지타입 불일치
A2040 동보발송 요청이 진행중이라서 타겟팅 값을 사용할 수 없음
A3000 예기치 않은 오류 발생
A3006 내부 시스템 오류로 메시지 전송 실패
A3008 전화번호 오류
A3010 Json 파싱 오류
A3011 메시지가 존재하지 않음
A3013 메시지가 비어 있음
A3014 메시지 길이 제한 오류(템플릿별 제한 길이 또는 1000자 초과)
A3015 템플릿을 찾을 수 없음
A3016 메시지 내용이 변수와 일치하지 않음
A3018 메시지를 전송할 수 없음
A3020 메시지 확인 정보를 찾을 수 없음
A3022 메시지 발송 가능한 시간이 아님(브랜드톡/마케팅 메시지는 08시부터 20시까지 발송 가능)
A3024 메시지에 포함된 이미지를 전송할 수 없음
A3027 버튼이 변수와 일치하지 않음
A3031 텍스트 유형 불일치
A4000 메시지 전송 결과를 찾을 수 없음
A4001 알 수 없는 메시지 상태
A9998 시스템에 문제가 발생하여 담당자가 확인하고 있는 경우
A9999 시스템에 문제가 발생하여 담당자가 확인하고 있는 경우
B7013 발송 제약 시간(20:50~익일 08:00) 에러
B7014 메시지 유효 시간 초과 에러
B7015 메시지 길이 제한 오류
B7017 내부 시스템 오류로 메시지 전송 실패
TOP